PowerChute Network Shutdown
Installation Guide


 
Table of Contents

Software and Hardware Requirements

To install PowerChute Network Shutdown, you should have the following:

Installation

To install and operate the PowerChute Network Shutdown software, perform the following steps.

  1. Install the Network Management Card in your UPS. For installation instructions, see the Management Card Installation and Quick Start Guide that was shipped with your card. If you are using multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS, you will use one Network Management Card in each UPS in the system.

    Install the Card in your UPS and configure it with an IP address before beginning the PowerChute Network Shutdown software installation. If you install PowerChute Network Shutdown first, additional steps will be required when installing the Network Management Card.

  2. Using the Network Management Card user interface, configure the UPS and the Network Management Card. At a minimum, perform these tasks:
  3. Remove any existing version of PowerChute Network Shutdown before starting the installation program.

    WARNING: Do not install and use PowerChute Network Shutdown on a computer system that uses PowerChute plus or PowerChute Business Edition.

  4. The installation program must be run on the server console.

    To start the PowerChute Network Shutdown installation, choose from the sections directly below specifying different OS systems and hardware.

    For installation on a IA-64 processor machine, follow these steps:

    1. Manually install J2SDK (JavaTM 2 SDK, Standard Edition) 1.4.2_03.
       
    2. Set the path to the Java file:
       
      • for Windows: [#JavaHomeDir]/java -cp .;pcns221win64.jar;util.jar load
         
      • for Linux: [#JavaHomeDir]/java -cp .:pcns221lnx64.jar:util.jar load
         
    3. Use pcns221win64.jar on Windows or pcns221lnx64.jar on Linux, and util.jar, all included in the CD to commence the installation.

    For installation on Windows 2000, Windows XP or Windows 2003, you can double-click the installation program icon or execute the file pcns221win.exe from a command line. Launch the installation program for Windows. After you complete the installation, you can use the Silent Installation to set up additional computers to have the same PowerChute Network Shutdown configuration.

    For installation on Solaris and Linux, perform the following steps. After you finish the installation, you can use the Silent Installation to set up additional servers to have the same PowerChute Network Shutdown configuration.

    1. If you downloaded the file pcns221lnx.bin for Linux or pcns221sol.bin for Solaris from the APC Web site, copy the file to a temporary directory on the file server.

      If the software is on a CD, copy the installation file from the CD to a temporary directory on the file server.

    2. Change your working directory to the directory containing the installation file. Change the permissions on the file to make it executable. Then type the following command:
      ./pcns221lnx.bin         for Linux

      ./pcns221sol.bin         for Solaris 8 or 9

    For installation on NetWare, perform the following steps.

    1. If you downloaded the file pcns221net.exe from the APC Web site, copy the file to a temporary directory on the SYS: volume of the NetWare file server; then execute the file to extract the installation files.

      If the software is on a CD, copy the installation files (pcns221net.jar and util.jar) from the NetWare directory on the CD to a temporary directory on the SYS: volume of your NetWare file server.

    2. From the server's System Console command prompt, enter the following command (where tempdirectory represents the location of the installation files).
      java -cp SYS:\tempdirectory\pcns221net.jar;SYS:\tempdirectory\util.jar load
  1. At the following prompt, type "yes" to continue the installation:

    You are about to install a new application. Continue?
  2. In the "About" box, select Next.
  3. Select I agree to accept the terms of the PowerChute Network Shutdown license agreement. If you do not accept the agreement, you must select Cancel and cannot install PowerChute Network Shutdown.
  4. Select the location where the PowerChute Network Shutdown software will be installed. To choose a location other than the default, type the full path name, including the drive letter or volume name, or use the Browse button. Select Next.
  5. Choose the installation type.
    •  Select Custom Install a) if you have multiple Smart-UPS or Symmetra devices, or a Parallel Silcon UPS or b) if your server has more than one network interface card (NIC)/ network adaptor (in order to choose the adaptor you want to use for PCNS). Then select the appropriate setting for your UPS system, and select Next.
    •  Select Typical Install if you do not have multiple Smart-UPS or Symmetra devices, or a Parallel Silcon UPS.

    Different VA models are supported if they are in the same UPS device family. The Symmetra Tower and the Symmetra RM are considered a family. The Symmetra PX is not however in the same family and can't be used in combination with them.

    The IP address of the PowerChute Network Shutdown computer is registered with the Network Management Card if a UPS fails to register. You should manually remove it in this circumstance: Registering an IP Address with the Network Management Card.

  6. Enter the initial configuration information:
    • Management Card IP: This is the network address of the Network Management Card attached to your UPS.

      If you are using multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS, enter the IP address of the Network Management Card in the first UPS device, select Add, and then continue adding IP addresses for all of the cards in this UPS system. (Up to 3 IP addresses for multiple Smart-UPS devices and multiple Symmetra devices, and up to 9 IP addresses for a Parallel Silcon UPS.)

    • The http port being used by the Network Management Card. The default is 80. Do not change this number unless you changed the http port being used by your Management Card. For multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS system, all of the Network Management Cards must use the SAME http port.
       
    Click Next to continue.
     
  7. Enter the security configuration information:

    The default settings for User Name, Authentication Phrase and Password are the same for both PowerChute Network Shutdown and the Network Management Card. If you have not changed the default settings in the Network Management Card, click Next; otherwise, enter the same values used by the Network Management Card and click Next.

    The User Name and Authentication Phrase authenticate the communication between PowerChute Network Shutdown and the Network Management Card. You use the same User Name and Password to log on to the user interface of PowerChute Network Shutdown and the Network Management Card.

    If you are using multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS system, all of the Network Management Cards in the UPS system must use the same Administrator User Name and Authentication Phrase.

    Note: Any Java exceptions displayed during the installation will not affect the successful completion of the installation or operation of PowerChute Network Shutdown.

  8. Complete the software installation:

    PowerChute Network Shutdown registers with the Network Management Card automatically so that they can communicate.

    If PowerChute Network Shutdown cannot register with the Management Card, you receive an error message. You may continue the installation, but you must enter the server IP address manually at the Network Management Card.

    On NetWare, a pop-up message asks whether changes to the autoexec.ncf file can be made. You should select Yes (otherwise the service won't start when the OS starts).

    Notes

    • If you select Cancel to stop the installation, the jvm directory remains under C:\Program Files\jvm (in Windows), and the /usr/local/bin/jvm (in Linux). The directory must be deleted manually before attempting another installation. You should also delete the PowerChute directory.
       
    • The Temp directory might have some sub-directories remaining after the installation. You can remove these manually, but they won't affect your computer system or PowerChute Network Shutdown.

  9. Start the PowerChute Network Shutdown process:

    The PowerChute Network Shutdown service (on Windows 2000, Windows XP and Windows 2003), the daemon (on Linux and Solaris), or the process (on NetWare) starts automatically when the installation is completed. You can then delete the installation files.

    Note: After installation, set access on the PowerChute directory so that only authorized users can access, execute, or remove the software.

  10. Open the PowerChute Network Shutdown user interface:

    Using a Web browser, enter either of the following URLs:

    http://servername:3052
    http://serverIPaddress:3052
    For example, if your server is named COMP1 and has an IP address of 117.14.53.59, use one the following URLs:
    http://COMP1:3052
    http://117.14.53.59:3052

    If you are using a browser version other than Microsoft Internet Explorer version 5.5 or 6.0, some functions may not be available.

Silent Installation

You can perform a silent installation on systems with a single UPS only. You must perform a normal installation on multiple Smart-UPS devices, multiple Symmetra devices or Parallel Silcon UPS systems.

On Windows 2000, Windows XP, Windows 2003, Linux and Solaris systems, you can install PowerChute Network Shutdown from a command line, which allows you to set up many servers that run the same operating system and that have the same PowerChute Network Shutdown configuration. To install PowerChute Network Shutdown silently, perform the following steps:

  1. Complete a normal installation on one server.
  2. Configure PowerChute Network Shutdown to have all of the settings that you want.
  3. Copy the m11.cfg and silentInstall.ini files from the PowerChute directory.
  4. Edit the silentInstall.ini file to have new parameters, if required. Precede each path separator ('\' for Windows and '/' for Linux and Solaris) with an escape character ('\').

  5. If you are installing PowerChute Network Shutdown for a UPS with a different IP address, uncomment and edit the adapterIPAddress parameter in the silentInstall.ini file. Enter the IP address of the Network Management Card that is in the UPS.
  6. Put the m11.cfg file, the silentInstall.ini file, and the PowerChute Network Shutdown installation files in a temporary directory on the new server.
  7. Use the commands specified below on the relevant system. For all systems, if there are spaces in the path to the temporary directory, enclose the path in quotation marks. For example:
    C:\pcinstall\pcns221win.exe -q "C:\Program Files\InstallDir\silentInstall.ini"
    C:\pcinstall\pcns221win.exe -q C:\InstallDir\silentInstall.ini
 
Registering an IP Address with the Management Card

If the installation program cannot communicate with the Network Management Card, you must manually register the IP address of the computer on which PowerChute Network Shutdown is installed. In some cases, the installation program registers the IP address, but is unable to confirm that it is registered; in such cases, you must check to ensure that the IP address is registered.

  1. Access the Network Management Card's user interface by using the Network Management Card IP address as the URL.
  2. Click on the UPS model name displayed on the menu.
  3. Select the PowerChute menu option to display a list of the IP addresses which are registered with this Network Management Card.
  4. To add a new IP address, type the IP address of the server on which PowerChute Network Shutdown is installed in the Add Client IP Address field, and click Add.

    To remove existing IP addresses, select each address from the Configured Client IP Addresses list, and click Remove.

 
Using the PowerChute Network Shutdown Configuration Utility

The stand-alone PowerChute Network Shutdown Configuration Utility allows you to change the following PowerChute Network Shutdown settings:

To run the Configuration Utility, type the relevant commands listed in the sections below for your operating system.

Note: The following instructions assume that you installed PowerChute Network Shutdown to the default directory.

Running the Configuration Utility on Windows 2000, Windows XP, and Windows 2003

Copy the m11.cfg file to the PowerChute\lib directory. The default installation directory is C:\Program Files\PowerChute.

Note: If there are spaces in the path to the java directory, enclose the path in quotation marks.

Enter the IP address of the Network Management Card you wish to monitor, and click Save. Your configuration settings have been saved. Click OK. On the following screen, click Exit.

In the Windows Control Panel, stop the PowerChute Network Shutdown service. Delete the m11.cfg file from the PowerChute directory. Move the modified m11.cfg file from the PowerChute/lib directory to the PowerChute directory. Start the PowerChute Network Shutdown service.

Running the Configuration Utility on Linux or Solaris

Copy the m11.cfg file to the PowerChute/lib directory. The default installation directory is /usr/local/bin/PowerChute.

Enter the IP address of the Network Management Card you wish to monitor, and click Save. Your configuration settings have been saved. Click OK. On the following screen, click Exit.

Stop the PowerChute Network Shutdown service.

Delete the m11.cfg file from the PowerChute directory. Move the modified m11.cfg file from the PowerChute/lib directory to the PowerChute directory.

Start the PowerChute Network Shutdown service.

You can use the Configuration Utility to set up m11.cfg files to monitor several Network Management Cards by using the same PowerChute Network Shutdown configuration that you used for silent installations.

  1. Perform a complete installation.
  2. Copy the m11.cfg file to \lib directory.
  3. Run the Configuration Utility.
  4. Use the Configuration Utility to change the Network Management Card IP address.
  5. Use the modified m11.cfg file to perform a command line installation. (See Silent Installation, step #4.)
Running the Configuration Utility on NetWare
  1. While the PowerChute NetWare Shutdown daemon is running, copy m11.cfg to the lib directory under the PowerChute installation directory.
  2. On the System Console, type the following command on one line:

    java -cp SYS:\<install directory>\lib\m11.jar;SYS:\<install directory>\lib\confutil.jar;SYS:\<install directory>\comp\Notifier.jar;SYS:\<install directory>\comp\CommandFileRunner.jar PCNSUtilApp
     
  3. Change the settings and save them.
  4. Exit from the wizard.
  5. Restart the daemon.
Running on Windows® 2000, Windows® XP, or Windows® 2003

You must have Windows 2000, Windows XP, or Windows 2003 to use PowerChute Network Shutdown. Always use the latest available Service Pack.

The PowerChute directory includes DLL files to shut down some common applications. See the Run Command File section in the Help.html file for information on which applications and how to shut them down.

To remove PowerChute Network Shutdown, uninstall the program from the Control Panel. If you do not intend to reinstall the software, remove the server IP address from the Network Management Card by using the PowerChute option on the Network Management Card's Web interface menu.

The PowerChute directory sometimes remains after an uninstall. You can remove this manually, but it won't affect your computer system or PowerChute Network Shutdown.

For information on using the Configuration Utility, see Running the Configuration Utility on Windows 2000, Windows XP, and Windows 2003.

Running on SolarisTM

You must have Solaris version 5.8 or 5.9 (SPARC) to use PowerChute Network Shutdown. XWindows is required to install PowerChute Network Shutdown.

PowerChute Network Shutdown requires Java Virtual Machine (JVM), version 1.4.2 or later, on your server. Obtain this JVM from the Sun Microsystems Web site, or contact your Sun Microsystems service provider. PCNS installs JVM 1.4.2 if the most recent version found on your system is less than this. If a JVM version greater than 1.4.2 is found on your system, PCNS will use the later version. It is recommended that the location of the JVM executable (java.exe) be in the PATH environment variable prior to installing PowerChute Network Shutdown. The JRE install path on Solaris is /usr/bin/jvm.

When the daemon starts, the script adds 256 file handles; delete ulimit -n 256 from the PowerChute Network Shutdown startup script if you do not need them.

To stop PowerChute Network Shutdown, type the following at the command line:

/etc/rc2.d/S99PowerChute stop
To start PowerChute Network Shutdown manually, type the following at the command line:
/etc/rc2.d/S99PowerChute start

To remove PowerChute Network Shutdown, run the uninstall script. If you do not intend to reinstall the software, remove the server IP address from the Network Management Card by using the PowerChute option on the Network Management Card's Web interface menu.

The PowerChute directory sometimes remains after an uninstall. You can remove this manually, but it won't affect your computer system or PowerChute Network Shutdown.

For information on using the Configuration Utility, see Running the Configuration Utility on Linux or Solaris.

Running on Linux®

XWindows is required to install PowerChute Network Shutdown.

To run PowerChute Network Shutdown on Red Hat Linux, you must use version 8.0 or greater.

PowerChute Network Shutdown requires Java Virtual Machine (JVM), version 1.4.2 or later, on your server. Obtain this JVM from http://java.sun.com/, or contact your Linux vendor or service provider. PCNS installs JVM 1.4.2 if the most recent version found on your system is less than this. If a JVM version greater than 1.4.2 is found on your system, PCNS will use the later version. It is recommended that the location of the JVM executable (java.exe) be in the PATH environment variable prior to installing PowerChute Network Shutdown. The JRE install path on Linux is /usr/local/bin/jvm.

Notes for the SuSE operating system:

To stop PowerChute Network Shutdown, type the following at the command line (see the note above for SuSE):

/etc/rc.d/init.d/PowerChute stop
To start PowerChute Network Shutdown manually, type the following at the command line (see the note above for SuSE):
/etc/rc.d/init.d/PowerChute start

To remove PowerChute Network Shutdown, run the uninstall script. If you do not intend to reinstall the software, remove the server IP address from the Network Management Card by using the PowerChute option on the Network Management Card's Web interface menu.

The PowerChute directory sometimes remains after an uninstall. You can remove this manually, but it won't affect your computer system or PowerChute Network Shutdown.

For information on using the Configuration Utility, see Running the Configuration Utility on Linux or Solaris.

Running on Novell® NetWare®

To uninstall PowerChute Network Shutdown on NetWare, follow these steps:

  1. Confirm the process ID for Java with this command:
    java -show
  2. Kill the Java process:
    java -killxxx (where xxx is a process ID)
  3. Delete the line for PCNS in autoexec.NCF (#START PowerChute ,,,,,,)
    nwconfig
  4. Delete the [SYS:Pwrchute] directory

To restart the PowerChute Network Shutdown daemon, follow these steps:

  1. Confirm the process ID for Java with this command
    java -show
  2. Kill the Java process
    java -killxxx (xxx is a process ID)
  3. Run APCpcns.ncf in the PowerChute directory.

For information on using the Configuration Utility, see Running the Configuration Utility on NetWare.

Running a Multiple-UPS Configuration (Smart-UPS and Symmetra)

A multiple-UPS configuration is also know as a "redundant UPS" configuration where one of several UPSs a) only partially shares the load or b) operates as a stand-by to back up a faulty unit. Specifically, PowerChute Network Shutdown can manage up to three Smart-UPS or Symmetra units (of the same model type) providing redundant backup power to a single server. In this configuration, each UPS in the system has its own Network Management Card (AP9617, 18, or 19) with PowerChute Network Shutdown recognizing the entire configuration as a single UPS.

Caution: In a multiple-UPS configuration, each UPS must have enough capacity to carry all the electrical load of the computer system. So, for example, if you had two UPSs in a multiple configuration, and one stops supplying power, the other UPS must have enough capacity to continue supplying power to protect the computer system.

For a multiple-UPS configuration, you must have PowerChute Network Shutdown 2.2 or greater. See also Requirements.

You can't upgrade to a multiple-UPS configuration from a previous version of PowerChute Network Shutdown: you must uninstall, install the new version, and re-configure your options.

With a multiple configuration, PowerChute Network Shutdown always recognizes and logs the events in the groups listed below (see the text on individual events in the List of Events section in Help.html):

For the Environmental Monitoring Card and Runtime Exceeded events, any actions you configured for the event will be instigated (see the Configuring Events section in Help.html).

Notes: With multiple-UPS configurations:

For details on Advanced Configuration, see the Advanced Configuration section in the Help Guide.